home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / pntsmo.z / pntsmo
Encoding:
Text File  |  2002-10-03  |  6.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ppppnnnnttttssssmmmmoooo((((3333GGGG))))                                                          ppppnnnnttttssssmmmmoooo((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppnnnnttttssssmmmmoooo - specify antialiasing of points
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppnnnnttttssssmmmmoooo((((mmmmooooddddeeee))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 mmmmooooddddeeee
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _m_o_d_e   expects one of two values:
  17.  
  18.             SSSSMMMMPPPPOOOOFFFFFFFF defeats antialiasing of points (default).
  19.  
  20.             SSSSMMMMPPPPOOOONNNN enables antialiasing of points.  It can be modified by an
  21.             optional symbolic constant:
  22.  
  23.             SSSSMMMMPPPPSSSSMMMMOOOO indicates that a higher quality filter should be used
  24.             during point drawing.  This filter typically requires that more
  25.             pixels be modified, and therefore potentially reduces the rate at
  26.             which antialiased points are rendered.
  27.  
  28.      The constant SMPSMO is specified by bitwise ORing it, or by adding it, to
  29.      SMPON.  For example:
  30.  
  31.           pntsmo(SMPON + SMPSMO)
  32.  
  33.  
  34.      enables antialiased point drawing with the highest quality, and
  35.      potentially lowest performance, algorithm.  The modifier is a hint, not a
  36.      directive, and is therefore ignored by systems that do not support the
  37.      requested feature.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      ppppnnnnttttssssmmmmoooo controls the capability to draw antialiased points.  You can draw
  41.      antialiased points in either color map mode or RGB mode.
  42.  
  43.      For color map antialiased points to draw correctly, you must initialize a
  44.      16-entry colormap block (whose lowest entry location is a multiple of 16)
  45.      to a ramp between the background color (lowest index) and the point color
  46.      (highest index).  Before drawing points, clear the area to the background
  47.      color.
  48.  
  49.      The pntsmooth hardware replaces the least significant 4 bits of the
  50.      current color index with bits that represent pixel coverage.  Therefore,
  51.      by changing the current color index (only the upper 8 bits are
  52.      significant) you can select among many 16-entry color ramps, representing
  53.      different colors and intensities.  You can draw depthcued antialiased
  54.      points in this manner.
  55.  
  56.      The z-buffer hardware can be used to improve the quality of color map
  57.      antialiased point images.  Enabled in the standard depth-comparison mode,
  58.      it ensures that points nearer the viewer obscure more distant points.
  59.      Alternately, the z-buffer hardware can be used to compare color values by
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppnnnnttttssssmmmmoooo((((3333GGGG))))                                                          ppppnnnnttttssssmmmmoooo((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      issuing:
  75.  
  76.               zbuffe(.TRUE.)
  77.                zsourc(ZSRCCO)
  78.                zfunct(ZFGREA)
  79.  
  80.  
  81.      Pixels are then replaced only by 'brighter' values, resulting in better
  82.      intersections between points drawn using the same ramp.
  83.  
  84.      RGB antialiased points can be drawn only on machines that support
  85.      blending.  For these points to draw correctly, the blendfunction must be
  86.      set to merge new pixel color components into the framebuffer using the
  87.      incoming (source) alpha values.  Incoming color components should always
  88.      be multiplied by the source alpha (BFSA).  Current (destination) color
  89.      components can be multiplied either by one minus the source alpha
  90.      (BFMSA), resulting in a weighted average blend, or by one (BFONE),
  91.      resulting in color accumulation to saturation; issue:
  92.  
  93.           c    weighted average
  94.                blendf(BFSA, BFMSA)
  95.  
  96.  
  97.      or
  98.  
  99.           c    saturation
  100.                blendf(BFSA, BFONE)
  101.  
  102.  
  103.      The pntsmooth hardware scales incoming alpha components by an 8-bit
  104.      computed coverage value.  Therefore reducing the incoming source alpha
  105.      results in transparent, antialiased points.
  106.  
  107.      RGB antialiased points draw correctly over any background image.  It is
  108.      not necessary to clear the area in which they are to be drawn.
  109.  
  110.      Both color map and RGB mode points are antialiased effectively only when
  111.      subpixel mode is enabled; issue:
  112.  
  113.                subpix(.TRUE.)
  114.  
  115.  
  116.      The size of antialiased points is controlled by ppppnnnnttttssssiiiizzzz and ppppnnnnttttsssszzzzffff....
  117.      Although point size can be arbitrarily specified, only a small, hardware
  118.      specific number of point sizes is actually supported.  (Refer to the
  119.      ppppnnnnttttssssiiiizzzz manpage.)
  120.  
  121.      The modifier SMPSMO can be ORed or ADDed to the symbolic constant SMPON
  122.      when antialiased points are enabled.  When this is done, a higher quality
  123.      and potentially lower performance filter is used to scan convert
  124.      antialiased points.  SMPSMO is a hint, not a directive.  Thus a higher
  125.      quality filter is used only if it is available.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppnnnnttttssssmmmmoooo((((3333GGGG))))                                                          ppppnnnnttttssssmmmmoooo((((3333GGGG))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      bgnpoi, blendf, endpoi, gversi, pntsiz, linesm, subpix, v, zbuffe,
  142.      zfunct, zsourc
  143.  
  144. NNNNOOOOTTTTEEEESSSS
  145.      This routine does not function on IRIS-4D B or G models, or on the
  146.      Personal Iris.  Use ggggvvvveeeerrrrssssiiii to determine which type you have.
  147.  
  148.      IRIS-4D GT and GTX models, as well as the Personal Iris, Iris Entry,
  149.      Indy, XL, XS, XS24, XZ, Elan and Extreme systems do not support SMPSMO.
  150.      These systems ignore this hint.
  151.  
  152.      Iris Entry ppppnnnnttttssssmmmmoooo support is only valid for color index mode.
  153.  
  154. BBBBUUUUGGGGSSSS
  155.      Color-comparison z-buffering is not supported on the IRIS-4D GT or GTX
  156.      models.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.